package cn.vehicle.service;

import cn.vehicle.domains.bo.QueryRoleBo;
import cn.vehicle.domains.entity.SysRoleEntity;

import java.util.List;

/**
 * 系统角色服务接口
 * <p>
 * 定义系统角色相关的核心业务操作，包括角色的新增、修改、删除和查询。
 * 该接口作为 Biz 层与数据库持久层之间的抽象层，提供统一的数据访问规范。
 * </p>
 *
 * <p>主要职责：</p>
 * <ul>
 *   <li>定义角色表（sys_role）的基础 CRUD 方法；</li>
 *   <li>支持通过条件对象进行角色查询；</li>
 *   <li>为业务层提供标准化的角色管理接口。</li>
 * </ul>
 */
public interface SysRoleService {
    /**
     * 新增角色
     *
     * @param sysRoleEntity 角色实体对象，包含角色编码、名称、状态等信息
     */
    void addRole(SysRoleEntity sysRoleEntity);

    /**
     * 根据ID查询角色详情
     *
     * @param id 角色主键ID
     * @return 角色实体对象
     */
    SysRoleEntity getRoleById(Long id);

    /**
     * 更新角色信息
     *
     * @param updateEntity 更新的角色实体对象，需包含主键ID
     */
    void updateRole(SysRoleEntity updateEntity);

    /**
     * 删除角色
     *
     * @param id 角色主键ID
     */
    void deleteRole(Long id);

    /**
     * 查询角色列表
     *
     * @param queryRoleBo 查询条件封装对象（支持分页、角色名称等筛选）
     * @return 角色实体列表
     */
    List<SysRoleEntity> selectRoleList(QueryRoleBo queryRoleBo);
}
